Skip to main content

upload-h5p-libraries.js

Overview​

upload-h5p-libraries.js is a Node.js script designed to upload H5P libraries from a specified temporary folder to their target destination (such as a server or cloud storage). It uses the H5pLibraryUploaderService to handle the upload process for all libraries found in the folder.

How It Works​

  1. Argument Parsing:
    • Uses the arg package to parse command-line arguments for the temporary folder location.
  2. Upload Process:
    • Instantiates H5pLibraryUploaderService with the provided temporary folder path.
    • Calls uploadLibraries() to upload all H5P libraries found in the folder.

Command-Line Options​

  • --help or -h: Show usage information.
  • --tmp or -t: Path to the temporary folder containing built H5P libraries.

Usage Example​

node scripts/h5p/upload-h5p-libraries.js --tmp /tmp/h5p-libraries

If no --tmp option is provided, the script will use the default or fail if the folder is not specified.

Prerequisites​

  • Node.js installed
  • Required dependencies installed (run npm install in the project root)
  • Temporary folder containing built H5P libraries

Required Environment Variables​

For uploading H5P libraries, only the following environment variables for the S3 Client Helper are required:

  • H5P_EDITOR__S3_ENDPOINT: The S3 endpoint URL (required)
  • H5P_EDITOR__S3_REGION: The S3 region (required)
  • H5P_EDITOR__LIBRARIES_S3_ACCESS_KEY_ID: The S3 access key ID (required)
  • H5P_EDITOR__LIBRARIES_S3_SECRET_ACCESS_KEY: The S3 secret access key (required)
  • H5P_EDITOR__S3_BUCKET_LIBRARIES: The S3 bucket name for libraries (required)

No other environment variables are necessary for the standard upload.

Make sure these variables are set in your environment before running the script. If they are missing, the upload will fail with an authentication or permission error.

Output​

  • The script uploads all H5P libraries found in the specified temporary folder.
  • Progress and results are logged to the console.

Troubleshooting​

  • Ensure the temporary folder exists and contains valid H5P libraries.
  • Check for errors in the console output for details.
  • service/h5p-library-uploader.service.js: Logic for uploading libraries

For further details, see inline comments in the script source code.